＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝

                        PC-FXGAオーサリングソフトウェア
                    『ＧＭＡＫＥＲ』スタータキット(Ver.1.1)
                     ”ＦＸＬＩＢ．ＥＸＥ(Ver.1.03)”の解説

                                        日本電気ホームエレクトロニクス株式会社
                                                        １９９６年０５月３０日

＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝

目次

第１章  ライブラリアン概要

第２章  ライブラリアンの使用書式

第３章  スイッチの使用書式

第４章  エラーメッセージ

＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝

第１章  ライブラリアン概要

プログラムの開発は、機能ごとのモジュールに分割して行うことが多いので、１つの実
行可能プログラムを作成する過程で数多くのオブジェクトファイルが作成されます。
このような複数個のオブジェクトファイルを機能ごとにまとめたファイルを、ライブラ
リファイルと呼びます。このライブラリファイルは、通常のオブジェクトファイルと同
様にリンカで使用する事ができます。

ライブラリアンはこのライブラリファイルの保守を行います。

＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝

第２章  ライブラリアンの使用書式


《名称》
fxlib - ライブラリアン

《書式》
fxlib [スイッチ] ライブラリファイル [オブジェクトファイル...]

《解説》
ライブラリアンは大きく分けて次の３つの動作を行ないます。

(1) オブジェクトの登録・更新

コマンドラインやコマンドファイル内で指定したオブジェクトファイルを指定した順序
でライブラリファイルに登録します。
また、すでに登録されているオブジェクトファイルを更新します。

(2) オブジェクトの抽出

コマンドラインやコマンドファイル内で指定したオブジェクトファイルをライブラリフ
ァイルから抽出します。

(3) オブジェクトの削除

コマンドラインやコマンドファイル内で指定したオブジェクトファイルをライブラリフ
ァイルから削除します。

《スイッチ》
ライブラリアンは以下の書式で使用します。

fxlib [スイッチ] [ライブラリファイル] [オブジェクトファイル...]

オブジェクトファイルは複数個指定できます。誤ったスイッチを指定した場合、以下の
ようなメッセージが出力されます。

       ＋－－－－－－－－－－－－－－－－－－－－－－＋
       ｜                                            ｜
       ｜  FXLIB                                     ｜
       ｜  Usage: fxlib [options] lib_file [file...] ｜
       ｜          @xxx    indirect file             ｜
       ｜          -d      delete                    ｜
       ｜          -e      extract all               ｜
       ｜          -x      extract                   ｜
       ｜          -m      move to archive           ｜
       ｜          -r      update(default)           ｜
       ｜          -u      update only newer         ｜
       ｜          -t      show object file list     ｜
       ｜          -p      show public symbol list   ｜
       ｜          -V      show version              ｜
       ｜          -v      verbose mode              ｜
       ｜                                            ｜
       ＋－－－－－－－－－－－－－－－－－－－－－－＋

《ファイル名》
ライブラリファイル名には慣習的にサフィックス .a を使用します。

オブジェクトファイル名には .o を使用します。
コマンドラインまたはインダイレクトファイル（後述）で .a, .o を省略した場合は自
動的にサフィックスを補います。

《ライブラリファイルの構造》   ＋－－－－－－－－－－－－－－－－－＋
                               ｜    ファイルヘッダ                ｜
                               ｜    モジュールヘッダ１            ｜
                               ｜            ：                    ｜
                               ｜    モジュールヘッダｎ            ｜
                               ｜    パブリックシンボルストリング  ｜
                               ｜    オブジェクトモジュール１      ｜
                               ｜            ：                    ｜
                               ｜    オブジェクトモジュールｎ      ｜
                               ＋－－－－－－－－－－－－－－－－－＋
・ファイルヘッダ ----------------- ファイル識別ヘッダその他
・モジュールヘッダ --------------- オブジェクトモジュールについての情報
・パブリックシンボルストリング --- パブリックシンボル文字列の羅列
・オブジェクトモジュール --------- オブジェクトファイルイメージ
・オブジェクトファイル ----------- アセンブラから出力されるファイルです。
                                   ライブラリアンに指定できる１つのオブジェクト
                                   ファイル名は 32文字までです。

＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝

第３章  スイッチの使用書式

１）インダイレクトファイルの指定
インダイレクトファイルとはオプションやファイル名が記述されているテキストファイ
ルであり、長いコマンドラインの指定を簡潔にすることができます。

    @ファイル名

＜例＞

foo.ind の内容が以下の時、

    -r foo.a foo1.o foo2.o foo3.o foo4.o foo5.o foo6.o foo7.o foo8.o

fxlib @foo.ind と指定すると

    fxlib -r foo.a  foo1.o foo2.o foo3.o foo4.o foo5.o foo6.o foo7.o foo8.o

と指定したことになります。

２）ライブラリファイルからオブジェクトを削除する
コマンドラインやインダイレクトファイル内で指定したオブジェクトファイルをライブ
ラリファイルから削除します。

    -d

＜例＞

fxlib -d foo.a foo4.o

ライブラリファイル foo.a から オブジェクトファイル foo4.o を削除します。

３）ライブラリファイルからすべてのオブジェクトを抽出する
ライブラリファイルに登録されているオブジェクトファイルをすべて抽出します。

    -e

＜例＞

fxlib -e foo.a

ライブラリファイル foo.a に登録されているオブジェクトファイルすべてを取り出し
ます。

４）ライブラリファイルから指定したオブジェクトを抽出する
ライブラリファイルからオブジェクトファイルを抽出します。

    -x

＜例＞

fxlib -x foo.a bar.o poi.o

ライブラリファイル foo.a からオブジェクトファイル bar.o, poi.o を取り出します。

５）ライブラリファイルにオブジェクトファイルを移動する
ライブラリファイルにオブジェクトファイルを移動します。登録後、オブジェクトファ
イルは削除されます。

    -m

＜例＞

fxlib -m foobar.a fb1.o

ライブラリファイル foobar.a にオブジェクトファイル fb1.o を移動します。
fb1.o が登録された後、fb1.o が削除されます。

６）ライブラリファイルにオブジェクトファイルを登録する
ライブラリファイルにオブジェクトファイルを登録します。ライブラリファイルに同名
のオブジェクトがあっても上書きされます。オプションを何も指定しない場合、このオ
プションが指定されたことになります。

    -r

＜例＞

fxlib -r foo.a foo.o

ライブラリファイル foo.a にオブジェクトファイル foo.o を登録します。
fxlib foo.a foo.o と書いても同じです。

７）ライブラリファイルに新しいオブジェクトファイルを登録する
ライブラリファイルに新しいオブジェクトファイルを登録します。ライブラリファイル
に同名のオブジェクトがある場合、タイムスタンプが新しければ上書きされます。タイ
ムスタンプが同じ、または古ければなにもしません。

    -u

＜例＞

fxlib -u foo.a foo.o

ライブラリファイル foo.a にオブジェクトファイル foo.o を登録します。

８）ライブラリファイルに登録されているオブジェクトの一覧を見る
ライブラリファイルに登録されているオブジェクトファイルの一覧を表示します。

    -t

＜例＞

fxlib -t foo.a

９）ライブラリファイルに登録されているオブジェクトファイルのパブリックシンボル
    一覧を見る
ライブラリファイルに登録されているオブジェクトファイルのパブリックシンボル一覧
を表示します。

    -p

＜例＞

fxlib -p foo.a
foo_entry
foo1
foo2

１０）ライブラリアンのバージョンを表示する
ライブラリアンのバージョンを表示します。通常はタイトルやバージョン等は表示され
ません。

    -V

１１）ライブラリアンの動作を詳しく表示する
ライブラリアンの動作を詳しく表示します。

    -v

＜例１＞

fxlib -vu foo.a foo.o bar.o
bar.o is same or older
update foo.o

＜例２＞

fxlib -vd foo.a foo.o
delete foo.o

＜例３＞

fxlib -vx  foo.a foo.o bar.o
extract foo.o
extract bar.o

＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝

第４章  エラーメッセージ

＋－－－－－－－－－－－－－－－－＋－－－－－－－－－－－－－－－－－－－－＋
｜illegal switch -?               ｜不正なスイッチです。                    ｜
＋－－－－－－－－－－－－－－－－＋－－－－－－－－－－－－－－－－－－－－＋
｜too few arguments.              ｜引数がたりません。                      ｜
＋－－－－－－－－－－－－－－－－＋－－－－－－－－－－－－－－－－－－－－＋
｜cannot open ～                  ｜～がオープンできません。                ｜
＋－－－－－－－－－－－－－－－－＋－－－－－－－－－－－－－－－－－－－－＋
｜～is not HuLIB file.            ｜～はライブラリファイルではありません。  ｜
＋－－－－－－－－－－－－－－－－＋－－－－－－－－－－－－－－－－－－－－＋
｜～is not HuOBJ file.            ｜～はオブジェクトファイルではありません。｜
＋－－－－－－－－－－－－－－－－＋－－－－－－－－－－－－－－－－－－－－＋
｜～has only 1 object file.       ｜～はオブジェクトファイルを１つしか登録し｜
｜                                ｜ていません。                            ｜
＋－－－－－－－－－－－－－－－－＋－－－－－－－－－－－－－－－－－－－－＋
｜～：cannot delete all contents. ｜～の全ての内容を削除することはできませ  ｜
｜                                ｜ん。                                    ｜
＋－－－－－－－－－－－－－－－－＋－－－－－－－－－－－－－－－－－－－－＋
｜～：name is too long.           ｜～は名前が長すぎます。                  ｜
＋－－－－－－－－－－－－－－－－＋－－－－－－－－－－－－－－－－－－－－＋

＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝

《著作権及び登録商標等》

・FXLIB.EXE 及び FXLIB.TXT（以下、"本ソフトウェア"という）は、ＰＣ－ＦＸＧＡ用
  のソフトウェア開発ツールの一部です。本ソフトウェアを、ＰＣ－ＦＸ、ＰＣ－ＦＸ
  ＧＡ用のソフトウェア開発以外の目的で使用しないで下さい。

・本ソフトウェアを使用した結果、直接及び間接的に生じた損害について、株式会社ハ
  ドソンは、一切の責任または債務を負わないものとします。

・本ソフトウェアの操作方法、技術的内容、その他の質問について、株式会社ハドソン
  では、直接お答えしていません。お問い合わせはご遠慮下さい。

・本ソフトウェアの使用に際し、「ソフトウェアのご使用条件」をよくご覧いただき、
  ご利用下さいますようお願い致します。

・本ソフトウェアの著作権は、株式会社ハドソンが保有しています。


MS-DOSは米国マイクロソフト社の登録商標です。
その他、記載されている会社名、製品名は、各社の登録商標または商標です。


                                                            (C)1995 HUDSON SOFT

